home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: MegaDisc / MegaDisc 08 (1988)(MegaDisc Digital Publishing)(AU)[WB].zip / MegaDisc 08 (1988)(MegaDisc Digital Publishing)(AU)[WB].adf / PROGRAMS / Wicon.doc < prev    next >
Text File  |  1988-05-28  |  10KB  |  262 lines
  1.  
  2.  
  3.                WICON version 2.0
  4.             Steven Sweeting 28-August-1988
  5.             Special MegaDisc release
  6.  
  7.      [Ed. Note: This program is great, I find I use it all the time. If
  8.      you have a CLI window going, or any other window taking up space
  9.      on the screen, you can shrink it down to a small "icon" to put it
  10.      out of the way without removing it. Then when you need it again,
  11.      get it back with a single click! I've been running it for weeks,
  12.      and it has never crashed, and has saved me a lot of time closing
  13.      and opening windows. Read through the entire document to find out
  14.      the little extras you can use as well - and it is a good command
  15.      to put in your Startup-Sequence, as in    > run c:wicon     . To
  16.      try it now, click this PRINTEXT window to the back using the
  17.      back/front gadgets top right,double-click the WICON icon, then
  18.      click once on the Printext window again to make it active, then
  19.      click once with the Right mouse button - good, eh? Just don't
  20.      move the mouse as you click ]
  21.  
  22. NAME
  23.      wicon - Window Iconifier
  24.  
  25.  
  26. RUNITQUICK
  27.      Just type in wicon at the CLI prompt, or double click the icon to
  28.      start.  To quit, double click the icon again, or re-run from the
  29.      CLI.  The default settings for Wicon are those most people use.
  30.  
  31.      Make a window the active window by clicking in it with the Left
  32.      Mouse Button. Now, without moving the mouse, give the Right Mouse
  33.      Button a quick tap.  The Window will disappear and in its place
  34.      a smaller window.  Now hit the Right Mouse Button again and the
  35.      original window comes back up.
  36.  
  37.      Wicon steals that quick Right Mouse Button click.  So to for example
  38.      get a menu on a window, hold the button down longer until it appears,
  39.      or move the mouse as you press the button.
  40.  
  41.      If you would like to modify the options read below:
  42.  
  43. SYNOPSIS
  44.      wicon [-[!]a] [-b [/|*]boxes] [-c [+|-]chars] [-[!]d] [-[!]f]
  45.        [-[!]i] [-l lines ][-p [+|-]priority] [-[!]q] [-[!]r]
  46.        [-[!]s] [-[!]t] [-[!]w] [-W console] [-[!]&]
  47.      wicon ?        ; list arguments and their defaults
  48.      wicon          ; close an invocation of wicon
  49.  
  50.  
  51.  
  52. DESCRIPTION
  53.      Wicon operates on only one screen at a time. The WorkBench
  54.      screen is chosen unless the -f (first screen) argument is
  55.      set.  A Window can be `iconified', when it is `active' by hitting
  56.      it with the RMB (Right Mouse Button). The specific method
  57.      depends on the code, at the moment, you must not move the
  58.      mouse between pressing and releasing the RMB. This must also
  59.      be done within DoubleClickTime(3), ie set from Preferences.
  60.  
  61.      Some windows are by exempt from this iconification. Workbench
  62.      windows are those that are controlled a 'loadwb' program. This was
  63.      done because when a window's icon is double-clicked, that window
  64.      (if already open) is brought to the front. However to iconify these
  65.      windows would be an advantage to those with floppys and full
  66.      directorys. Just use "WBWINDOWS=TRUE" or "-w" to be able to
  67.      iconify them [Ed: this is the way it's set up on this disk - but
  68.      if you don't want Workbench windows to iconify, change the Icon INFO
  69.      to WBWINDOWS=FALSE].
  70.  
  71.      After much experimenting, I found that I liked to iconify windows
  72.      with a single Right Mouse Button (RMB) click.  This causes problems
  73.      on programs that do things on a RMB event :
  74.  
  75.      1> To get a menu
  76.      2> To freeze a display
  77.      3> To choose something on the display
  78.  
  79.      The solution was, to not give the process (or active window) the
  80.      RMB down and up events if they were signally Wicon to do its bit.
  81.      For (1) and (2) this was Ok, because you just move the mouse a
  82.      little and you don't think anythings amiss.
  83.  
  84.      Unfortunately for things like AMIGAP and DME, where it is nice to
  85.      use short sharp clicks, this was a pain.  So if RMBTRAP=FALSE
  86.      (which is the default) windows that expect RMB events,
  87.      (ie. Window->IDCMPFlags | RMBTRAP), can't be iconified. To be
  88.      able to iconfiy them, say "RMBTRAP=TRUE" or "-r"
  89.  
  90.      Note: During a RMB click, the event will not reach intuition
  91.        unless it is held down for DoubleClickTime(3), or the
  92.        mouse is moved!. Hence, to use menus quickly move the
  93.        mouse as you click the RMB.
  94.  
  95.      Wicon currently is installed with MacWin, which does `rubber-
  96.      banding' on OpenWindow & CloseWindow (as well as Iconification).
  97.      ie. Does it for all Windows in the system. To turn it off,
  98.      set BOXES=0 in the Wicon.info or use -b0 on the command line.
  99.      To use it on only the `Wicon' screen, turn the ALLSCREENS flag
  100.      off "-!a" or "ALLSCREENS=FALSE".
  101.  
  102.      All of the command line options can be used from WorkBench, ie
  103.      in the wicon.info, just make them ToolTypes. Also the Manx one
  104.      WINDOW=CON:X/Y/W/H/name can be used as well. (for error msgs).
  105.      You can also use the standard ones like `BOXES=30',
  106.      ie instead of `-B30'.
  107.  
  108.      The Command line will accept things like:
  109.  
  110.     wicon -b 30 -p +5       ; \
  111.     wicon -b30 -p+5     ;  > 30 boxes, increase priority by 5
  112.     wicon BoxEs=30 PRI=+5   ; /
  113.     wicon -b /2         ; only use 1/2 the default boxes
  114.     wicon -b0x11        ; 17 (in hex) boxes
  115.     wicon -b 013        ; 11 (in octal) boxes
  116.     wicon BOXES=\13     ; 11 (in octal) boxes
  117.  
  118.     The `-' options are all case sensitive. The string ones, e.g. 'BoXeS'
  119.     aren't.
  120.  
  121.      -& | -!&
  122.      EXECUTE=boolean
  123.         If true, runs an invocation of itself. This would be used
  124.         from s:startup-sequence, ie "wicon -&" doesn't return
  125.         until its child is running, thus avoiding disk
  126.         thrashing with the subsequent script command. It does the
  127.         same thing as `runback -? wicon'. Argument checking is
  128.         carried out by the parent, so the child should be Ok, but
  129.         the parent exits after 10 seconds if it can't find the
  130.         child
  131.  
  132.      -a | -!a
  133.      ALLSCREENS=boolean
  134.         Turns off `MacWindows' for all but the Wicon Screen.
  135.         This is FALSE (-!a) by default.
  136.  
  137.      -b boxes
  138.      BOXES=short
  139.         The number of rubber-bands: each one takes one cycle, or
  140.         screen update. Default is 15, ie 15/50ths of a second
  141.         for PAL machines, 15/60ths for NTSC. When boxes=0, rubber
  142.         banding is turned off.
  143.  
  144.      -c chars
  145.      CHARSACROSS=short
  146.         The number of characters displayed in an iconfied
  147.         window's title. Default is 12. This excludes depth
  148.         gadgets. (ie when DEPTHGADGETS=TRUE the window is longer)
  149.  
  150.      -d | -!d
  151.      DEPTHGADGETS=boolean
  152.         Whether the wicons (Windows impersonating icons) have
  153.         depth arrangement gadgets. (They take up about 50 pixels).
  154.         Default is true (-d). When STICKY=TRUE, then
  155.         DEPTHGADGETS=FALSE, otherwise the wicons would dissappear.
  156.  
  157.      -f | -!f
  158.      FIRSTSCREEN=boolean
  159.         Rather than use WorkBench as your Wicon Screen, use the
  160.         FirstScreen. Just move the screen you want to the front.
  161.         This is FALSE by default (-!f).
  162.  
  163.      -i | -!i
  164.      ICONIFY=boolean
  165.         Whether to do the Iconification stuff at all, ie if you
  166.         just want the rubber-band window opening & closing.
  167.         Default is on (-i)! That means say -!i to turn it off.
  168.  
  169.  
  170.      -l number
  171.      LINES=short
  172.         The number of lines of icons to stack down the bottom. (My
  173.         and Tim's preferred place). Default is 1, which builds one
  174.         line down the bottom, then starts building up. If Lines=0,
  175.         the windows' wicons are placed where they are (parent X,Y).
  176.  
  177.      -p priority
  178.      PRIORITY=short
  179.         Changes this tasks priority. I can't imagine why this
  180.         would make much difference, (and it doesn't). The default
  181.         is (-p+0), which makes no change.
  182.  
  183.      -q | -!q
  184.      QUIET=boolean
  185.         If true, does not display the Copyright message. The
  186.         default is on (-q).
  187.  
  188.      -r | -!r
  189.      RMBTRAP=boolean
  190.         If true, then we also iconify those windows that
  191.         are receiving RMB (Right Mouse Button) events (through
  192.         RMBTRAP). Default is false (-!r).
  193.  
  194.      -s | -!s
  195.      STICKY=booelan
  196.        If true, iconifed windows stick to the WorkBench window,
  197.        ie behind application windows, just like a real Icon!
  198.        Default is false (-!s). Depth gadgets are off by default]
  199.        in this mode so that you can't inadvertently push your
  200.        icon behind the WorkBench (Backdrop) Window!
  201.  
  202.      -t | -!t
  203.      TESTING=boolean
  204.         Testing, just Opens and Closes a window using MacWin.
  205.         (ie Installs/Deinstalls OpenWindow & CloseWindow).
  206.         Default is false (-!t)
  207.  
  208.      -W string
  209.      WINDOW=string
  210.         Based on the Manx implementation (but fully independent)
  211.         a window is opened if a ToolType parsing error occurs.
  212.         The default window is "CON:0/0/640/100/Error Window". Note
  213.         the CAPITAL `W'. This doesn't work from CLI anyway.
  214.  
  215.      -w | -!w
  216.      WBWINDOWS=boolean
  217.         When true, WorkBench Windows ie those drawers etc that appear
  218.         from double clicking icons, are also available to be
  219.         iconified. Default is false (-!w).
  220.  
  221.  
  222.     To get a list of defaults, just type "wicon ?" or "wicon \?" from
  223.     shell or csh.
  224.  
  225. BUGS
  226.      As far as I know there is nothing wrong with wicon, however there
  227.      may be some programs out there that don't like it. Symptoms are:
  228.  
  229.      WICONs inherit their Parent Window Titles and ScreenTitles.
  230.      If these change, then Wicon doesn't know. This has never happened.
  231.  
  232.      Other programs that do not behave with respect to the Operating
  233.      System, such as MWB, may crash when you try and exit them. Wicon
  234.      will not exit if damaged in this way. i.e. it won't crash your
  235.      system.
  236.  
  237.  
  238. AUTHOR
  239.      Steven Sweeting 28-Aug-88
  240.  
  241.      ACSNET: steven@kylie.oz
  242.  
  243.      Thanks to Andrew Smith for being a pain w.r.t. the WIconification
  244.      method, and Tim Edgoose for suggesting LINES.
  245.  
  246. DISCLAIMER
  247.      This program is NOT in the public domain. Distribution for profit
  248.      (other than by non-profit organisaitons) may not take place without
  249.      consent from the Author.
  250.  
  251.      This notice must be included whenever this program is propagated.
  252.  
  253.      No guarantees expressed or implied.
  254.  
  255.      Portions Copyright (c) 1987 Davide P. Cervone (Input Handler)
  256.  
  257.  
  258. REVISION 2.0        Last Modified 28-Aug-88         (c) 1988
  259.  
  260.  XXXXXXXXXXXXXXXXXXXXXXXXXXX END OF WICON.DOC XXXXXXXXXXXXXXXXXXXXXXXXXXX
  261.  
  262.